home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CICA 1993 April
/
CICA MS Windows - April 1993.iso
/
unzipped
/
util
/
softerm3
/
hostmode.hlp
< prev
next >
Wrap
Text File
|
1992-04-01
|
12KB
|
309 lines
Host Mode
---------
The Softerm Host mode provides a general-purpose, unattended, remote
access mode which can be used interactively by other terminals and
systems. This is similar to an electronic BBS.
It can transfer files using the Character, Kermit, Xmodem, Ymodem or
Softrans protocols. Host mode functions as a server for the Kermit-Server
and Softrans file transfer protocols by automatically detecting a protocol
block while waiting for a command from the user. This means that a
command to initiate the file transfer is not required.
Host Mode Interactive Commands
------------------------------
Host mode responds to 28 interactive commands which you enter. The Host
system will transmit the following prompt when it is ready to receive a
command:
Ready
The following control characters may be used:
Character Action
--------- ------
BS ($08) Delete previous character
DEL ($7F) Delete previous character
ESC ($1B) Cancel command line
CTRL C ($03) Cancel output
CTRL S ($13) Stop Display
CTRL Q ($11) Resume Display
To abort the display of a file typed or a directory list, press CTRL C.
Output also is aborted if you press CTRL S to stop the display and it is
not resumed within 30 seconds. Host mode will timeout and display the
Ready prompt.
Important
---------
All commands are issued by the caller and tell Host mode to do something.
e.g.: If you want to send a file, you must instruct Host mode to prepare
to receive a file.
Exceptions to the Rule
----------------------
Because Host mode acts as a server for the Softrans and Kermit-Server file
transfer protocols, there are no commands to send and receive using those
protocols. You simply need to initiate the file transfer operation.
Many of the Host commands require arguments. The command and argument
must be separated by at least one space.
HELP
----
Display this Help information.
BYE
---
Terminate the current Host mode session and disconnect.
ACCEPT [-,&] d:\path\filename
-----------------------------
Used by the caller to send a file using character protocol. The filename
argument specifies the name of the file to receive the data.
If the very first character of the path\filename is a hyphen (-), the file
will replace a file of the same name on the Host system.
Example:
ACCEPT -C:\SOFTHOST\TEST.TXT
If the very first character of the path/filename is an ampersand (&), the
file will append to a file of the same name on the Host system.
Example:
ACCEPT &C:\SOFTHOST\TEST.TXT
If a file of the same name exists and neither special character is used,
the transfer will fail.
The host will display a GO> prompt when the system is ready to accept
data. Characters can be typed by the caller or a file can be transferred
using character protocol.
The ACCEPT command is terminated by a Ctrl Z character or a 60-second
timeout.
CALL d:\path\filename 1='string1'...5='string5'
-----------------------------------------------
Run a script file and then return to the Host mode. If logon processing
is in effect, all subsequent commands will observe the access restrictions
for the current user.
Note: We recommend that the CALLed script file does not end with the
CONVERSE command. This command places the Host Mode machine in Online
terminal emulation mode with unpredictable results.
The command line may include optional switches to specify the contents of
the Script Variables SV1-SV5 used in the script file as follows:
Switch Function
1='string' Replaces SV1 in script file
. . . . . .
5='string' Replaces SV5 in script file
Note: The quote marks are optional and would be necessary only if the
string contained embedded spaces.
Up to 5 strings can be specified which are substituted for dummy arguments
in the script file when the script file is run. Each string may be up to
64 characters in length. A dummy argument is defined in the script file
as SV followed by a number from 1 through 5. Thus, wherever SV1 occurs in
the script file, it will be replaced by the string defined for the SV1=
switch in the CALL command line. Note: The maximum length of the command
line is restricted to 128 characters.
CD d:\path
----------
Change the current default directory used for file names specified in file
transfer operations used in the Host mode. The new default directory,
including a drive specifier and directory path, is entered as an argument
on the command line. If the optional Host mode logon processing is inhe
current username.
CURRENT
-------
Display the default directory for file transfer operations used in the
Host mode. It initially is set to the current default directory when the
HOST() command is processed, or to the subdirectory in the password file
for the current user.
DELETE d:\path\filename
-----------------------
Remove an unwanted file from disk. If no drive or directory path is
entered, the file is deleted from the current directory. You can use the
wildcard characters ? and * in the filename and in the extension.
This command can be abbreviated to DEL.
DIR d:\path\filename
--------------------
The DIR command displays a list of the filenames in a specified directory.
If no drive or directory path is specified, all files in the current
default directory will be listed. The wildcard characters * and ? may be
used in the filename and extension parameters to list a subset of the
files in the specified directory.
ECHO <On or Off>
----------------
This command turns echo mode for the ACCEPT command on or off. If the
argument is specified as ON, characters transmitted to the host using an
ACCEPT command will be echoed back to the remote terminal or system for
visual confirmation. If the argument is specified as OFF, characters
received are not echoed. The echo mode defaults to ON.
KSEND d:\path\filename
----------------------
Prepare the Host system to send a file using the Kermit protocol. This
command can be used by remote Kermit programs unable to access a Kermit
server. The command is equivalent to a Kermit protocol SEND command. The
wildcard characters * and ? may be used in the filename or extension to
allow multiple files to be sent using a single command.
LF <On or Off>
--------------
This command turns the line feed mode for the TYPE and ACCEPT Host mode
commands on or off. If the argument is specified as ON, the host will add
line feed characters after carriage returns in transmitted or echoed data.
If the argument is specified as OFF, no line feed characters are added.
The line feed mode initially is set to ON.
LOGOUT
------
Terminate the current Host mode session and restart with logon processing
without a disconnect.
RECEIVE <profile_name or protocol_name> filename
------------------------------------------------
Prepare the Host system to receive the designated file using the
specified File Transfer profile or File Transfer Protocol. If a profile
and a protocol share the same name, the command will use the profile.
Note: This method lets you use the Honeywell-Kermit protocol with the
desired GCOS Mapping setting by using the appropriate profile.
RENAME d:\path\filename1 d:\path\filename2
------------------------------------------
Change the name of a file in the current or a specified directory. The
first file name entered with optional drive and path specification is the
file to be renamed, and the second file name is the new name. A drive or
path specification is not allowed in the new filename. The ? and *
wildcard characters are allowed.
This command can be abbreviated to REN.
SEND <profile_name or protocol_name> filename
---------------------------------------------
Prepare the Host system to send the designated file using the specified
File Transfer profile or File Transfer Protocol. If a profile and a
protocol share the same name, the command will use the profile.
Note: This method lets you use the Honeywell-Kermit protocol with the
desired GCOS Mapping setting by using the appropriate profile.
TERMINATE
---------
Terminate Host mode processing to interact directly with the script file
from which the HOST() command was started. If the optional Host mode
logon processing is in effect, the command is restricted by the access
restriction code.
TYPE d:\path\filename
---------------------
Cause a file to be typed or displayed by the Host system. The command is
equivalent to a character protocol SEND command. The display can be
cancelled by entering Ctrl C.
XRCV d:\path\filename
---------------------
Prepare the Host system to receive the designated file using the Xmodem
protocol. The filename specifies the file to receive the data.
Note: The caller may send the file using Xmodem, Xmodem-CRC or
Xmodem(Large Block) and the Host system will detect and adjust for the
error correction method and block size.
XSEND d:\path\filename
----------------------
Prepare the Host system to send the designated file using the Xmodem
protocol.
X1KSEND d:\path\filename
------------------------
Prepare the Host system to send the designated file using the Xmodem
(Large Block) protocol.
YGRCV [d:\path\filename]
------------------------
Prepare the Host system to receive the designated file using the Ymodem-G
protocol. The wildcard characters * and ? may be used in the filename or
extension to allow multiple files to be transferred using a single
command.
If the optional drive, path and file name are not specified, the command
will use the data in the protocol header block.
YRCV [d:\path\filename]
-----------------------
Prepare the Host system to receive the designated file using the Ymodem
protocol. The wildcard characters * and ? may be used in the filename or
extension to allow multiple files to be transferred using a single
command.
If the optional drive, path and file name are not specified, the command
will use the data in the protocol header block.
Note: The caller may send the file using Ymodem or Ymodem (Large Block)
and the Host system will detect and adjust for the block size.
YSEND d:\path\filename
----------------------
Prepare the Host system to send the designated file using the Ymodem
protocol. The wildcard characters * and ? may be used in the filename or
extension to allow multiple files to be transferred using a single
command.
Note: The caller may specify Ymodem-G to receive the file and the Host
system will detect and adjust for the block size and transmission method.
Y1KSEND d:\path\filename
------------------------
Prepare the Host system to send the designated file using the Ymodem
(Large Block) protocol. The wildcard characters * and ? may be used in
the filename or extension to allow multiple files to be transferred using
a single command.
Note: The caller may specify Ymodem-G to receive the file and the Host
system will detect and adjust for the block size and transmission method.